home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 6 / CU Amiga Magazine's Super CD-ROM 06 (1996)(EMAP Images)(GB)(Track 1 of 4)[!][issue 1997-01].iso / system / superview / superviewlibrary / docs / controlpads next >
Text File  |  1996-01-29  |  15KB  |  237 lines
  1.  
  2.   ControlPad-FAQ V12.3 (15.10.95)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.   List has been sorted alphabetically and by module types
  6.   (information has been derived from docs basing on CPInfo-Files).
  7.  
  8.   ============================================================================
  9.   MAIN LIBRARIES
  10.   ----------------------------------------------------------------------------
  11.   ControlPad-Name     : "ENV:superview-library/LIBRARY.controlpad"
  12.   ControlPad-Commands : - DEFAULTSVDRIVER=<#?.svdriver>
  13.                           ; Which SVDriver should be set, when
  14.                           ; superview-library is beeing initialized ?
  15.                           ; For example: "DEFAULTSVDRIVER=AGA.svdriver"
  16.                         - ANYDATATYPES
  17.                           ; if this KeyWord is set, ANY DataTypes will
  18.                           ; be loaded and tried to be displayed in some
  19.                           ; way (e.g. not only pictures, but also 8SVX
  20.                           ; sounds or ANIM-Files ...)
  21.                           ; Recognition of changes to this one does REQUIRE
  22.                           ; a re-initialization of the library,
  23.                           ; e.g. via reboot/reset or "avail flush"
  24.                           ; (when not accessed)
  25.   ----------------------------------------------------------------------------
  26.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  27.   ControlPad-Commands : - C2P=<OS|SV>
  28.                           ; determines, whether chunky to planar conversion
  29.                           ; is managed via the appropriate OS functions
  30.                           ; or via internal ones.
  31.                           ; Due to various problems with the OS functions
  32.                           ; "SV" is now default.
  33.                           ; Be careful when using "OS" with GfxCards,
  34.                           ; which carelessly patched graphics.library.
  35.   ============================================================================
  36.   SVOBJECTS
  37.   ----------------------------------------------------------------------------
  38.   ControlPad-Name     : "ENV:superview-library/FastILBM24.controlpad"
  39.   ControlPad-Commands : - BUFFERSIZE=<Size in Bytes>
  40.                           ; how many bytes should be buffered
  41.                             (more = faster)
  42.                           ; Default is 8192, minimum is 256
  43.                         - PASSTHROUGH
  44.                           ; do not recognize ANY pictures, so that
  45.                           ; they e.g. might be passed through to
  46.                           ; ILBM.svobject instead
  47.                         - DITHERMODE=<HAM6_QUICK|HAM8_QUICK>
  48.                           ; Default is HAM6_QUICK
  49.   ----------------------------------------------------------------------------
  50.   ControlPad-Commands : - COLORDEPTH = <8/24>
  51.                           ; should the output be done as 8 or 24 Bit Data ?
  52.                           ; default is 8 Bit data. Grayscaled graphics
  53.                           ; will _always_ be exported as 8 Bit
  54.                         - QUANTIZATION = <0..100>
  55.                           ; 0   - no quality, big compression
  56.                           ; 100 - best quality, no compression
  57.                           ; never use these values, but try something
  58.                           ; like 20, 50, 75 (default: 75)
  59.   ----------------------------------------------------------------------------
  60.   ControlPad-Name     : "ENV:superview-library/PCD.controlpad"
  61.   ControlPad-Commands : - OUTPUTFORMAT=<BASE/16 | BASE/4 | BASE >
  62.                           ; specifies the output resolution to be used
  63.   ----------------------------------------------------------------------------
  64.   ControlPad-Name     : "ENV:superview-library/SVG.controlpad"
  65.   ControlPad-Commands : - PACKMETHOD=<xxxx>
  66.                           ; if this one is specified, it is tried to
  67.                           ; pack the resulting file with the specified
  68.                           ; XPK-Packer. If this fails, the file keeps
  69.                           ; unpacked.
  70.   ============================================================================
  71.   SVDRIVERS
  72.   ----------------------------------------------------------------------------
  73.   ControlPad-Name     : "ENV:superview-library/AGA.controlpad"
  74.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  75.                           ; (case-sensitive, ".svoperator" may be added)
  76.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  77.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  78.                           ; specifies, which operation should be performed
  79.                           ; on 24 Bit graphics _before_ displaying them
  80.                           ; (if not specified, "best guess" colors will
  81.                           ;  be used, which is really slow)
  82.                         - BITMAPCOPY=<DIRECT|RTG>
  83.                           ; "BITMAPCOPY=RTG" prevents AGA.svdriver from
  84.                           ; directly copying into Bitmaps, which will
  85.                           ; result in a usage of more memory, but keeps it
  86.                           ; working.
  87.                           ; Default is "BITMAPCOPY=DIRECT".
  88.                         - SCREENINFRONT
  89.                           ; Put Screen to front _before_ the graphics
  90.                           ; has been displayed (useful with GfxCards)
  91.   ----------------------------------------------------------------------------
  92.   ControlPad-Name     : "ENV:superview-library/ECS.controlpad"
  93.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  94.                           ; (case-sensitive, ".svoperator" may be added)
  95.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  96.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  97.                           ; specifies, which operation should be performed
  98.                           ; on 24 Bit graphics _before_ displaying them
  99.                           ; (if not specified displaying will fail)
  100.                         - 8BITOPERATOR=<OperatorName>
  101.                           ; (case-sensitive, ".svoperator" may be added)
  102.                           ; e.g. "8BITOPERATOR=ExtractGrayScales"
  103.                           ; specifies, which operation should be performed
  104.                           ; on non-ECS graphics (more than 16 Colors in
  105.                           ; HighRes, more than 32 Colors in LowRes, HAM8)
  106.                           ; (if not specified, will be tried to display)
  107.                         - BITMAPCOPY=<DIRECT|RTG>
  108.                           ; "BITMAPCOPY=RTG" prevents ECS.svdriver from
  109.                           ; directly copying into Bitmaps, which will
  110.                           ; result in a usage of more memory, but keeps it
  111.                           ; working.
  112.                           ; Default is "BITMAPCOPY=DIRECT".
  113.                         - SCREENINFRONT
  114.                           ; Put Screen to front _before_ the graphics
  115.                           ; has been displayed (useful with GfxCards)
  116.   ----------------------------------------------------------------------------
  117.   ControlPad-Name     : "ENV:superview-library/CyberGraphics.controlpad"
  118.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  119.                           ; beginning depth for opening CyberGraphics Screens
  120.                           ; Default is 16 Bit (which will also be tried
  121.                           ; when opening of a 24 Bit Screen fails)
  122.                           ; This does not concern colordepths < 16 Bit,
  123.                           ; except HAM6/8.
  124.                         - SMALLSCREENS
  125.                           ; unless this KeyWord is specified, it is not
  126.                           ; tried to open screens smaller than 320x240
  127.   ----------------------------------------------------------------------------
  128.   ControlPad-Name     : "ENV:superview-library/PicassoII.controlpad"
  129.   ControlPad-Commands : - SMALLSCREENS
  130.                           ; unless this KeyWord is specified, it is not
  131.                           ; tried to open screens smaller than 320x240
  132.                         - BLITTER
  133.                           ; uses the Picasso blitter to copy graphics
  134.                           ; into screens. Otherwise CPU is used.
  135.                           ; On 68000 systems you may wish to use the blitter
  136.                         - EMUSCREENDEPTH=<16|24>
  137.                           ; beginning depth for opening Picasso Screens
  138.                           ; Default is 24 Bit (if opening fails, it is
  139.                           ; also tried to open a 16 Bit Screen, then)
  140.                         - SCREENMODEREQUEST
  141.                           ; if this one is specified, the SVDriver ITSELF
  142.                           ; will open a ScreenMode-Requester and ask
  143.                           ; for an appropriate Screenmode to use
  144.                           ; Useful, if you always like to change modes.
  145.                         - AUTOSCROLLADJUST
  146.                           ; this keyword will force Autoscroll whenever
  147.                           ; it would make sense, but the Picasso Software
  148.                           ; would not manage it by itself (when either
  149.                           ; only width or height need to be autoscrolled)
  150.   ----------------------------------------------------------------------------
  151.   ControlPad-Name     : "ENV:superview-library/Retina.controlpad"
  152.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  153.                           ; beginning depth for opening Retina Screens
  154.                           ; Default is 24 Bit (if opening fails, it is
  155.                           ; also tried to open a 16 Bit Screen, then)
  156.   ============================================================================
  157.   SVOPERATORS
  158.   ----------------------------------------------------------------------------
  159.   ControlPad-Name     : "ENV:superview-library/24BitToHAM.controlpad"
  160.   ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL
  161.                                       |HAM8_QUICK|HAM8_WELL>
  162.                           ; specifies the HAM-Mode to be used and
  163.                           ; the resulting speed/quality
  164.   ----------------------------------------------------------------------------
  165.   ControlPad-Name     : "ENV:superview-library/CallPNM24.controlpad"
  166.   ControlPad-Commands : - PNMCOMMAND=<PBM command path and name>
  167.                           ; PNM command to be called
  168.                           ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale
  169.                         - PNMOPTIONS=<Options>
  170.                           ; Options for PNM command to be called
  171.                           ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0
  172.   ----------------------------------------------------------------------------
  173.   ControlPad-Name     : "ENV:superview-library/Crop.controlpad"
  174.   ControlPad-Commands : - CROP_LEFTEDGE=<Value>
  175.                           ; crop from x position
  176.                           ; (will be adjusted, if >= source width)
  177.                         - CROP_TOPEDGE=<Value>
  178.                           ; crop from y position
  179.                           ; (will be adjusted, if >= source height)
  180.                         - CROP_WIDTH=<Value>
  181.                           ; crop how many x pixels from leftedge
  182.                           ; (will be adjusted, if too large)
  183.                         - CROP_HEIGHT=<Value>
  184.                           ; crop how many y pixels from topedge
  185.                           ; (will be adjusted, if too large)
  186.   ----------------------------------------------------------------------------
  187.   ControlPad-Name     : "ENV:superview-library/Dither24Bit.controlpad"
  188.   ControlPad-Commands : - COLORDEPTH=<1..8>
  189.                           ; specifies the colordepth of the dithering
  190.                           ; output (1->2 Colors .. 8->256 Colors)
  191.   ----------------------------------------------------------------------------
  192.   ControlPad-Name     : "ENV:superview-library/ExtractGrayScales.controlpad"
  193.   ControlPad-Commands : - COLORDEPTH=<1..8>
  194.                           ; specifies the colordepth of the grayscaled
  195.                           ; output (1->2 Colors .. 8->256 Colors)
  196.                         - QUICK
  197.                           ; uses >>2, >>1, >>3 (*0.25, *0.5, *0.125)
  198.                           ; instead of *0.3, *0.59, *0.11
  199.   ----------------------------------------------------------------------------
  200.   ControlPad-Name     : "ENV:superview-library/HilbertDither256.controlpad"
  201.   ControlPad-Commands : - BACKGROUND=<BLACK|WHITE>
  202.                           ; defines, which of the two colors will act
  203.                           ; as background color. Useful e.g. for printing.
  204.   ----------------------------------------------------------------------------
  205.   ControlPad-Name     : "ENV:superview-library/Rotate.controlpad"
  206.   ControlPad-Commands : - DEGREES=<90|180|270>
  207.                           ; rotate by how many degrees (reverse clockwise) ?
  208.   ----------------------------------------------------------------------------
  209.   ControlPad-Name     : "ENV:superview-library/RotateFree.controlpad"
  210.   ControlPad-Commands : - ROTATE_ANGLE=<0..360>
  211.                           ; rotate by how many degrees (reverse clockwise) ?
  212.                         - METHOD=<MIDDLE|GIVENPOINT>
  213.                           ; default is rotation about the middle
  214.                         - X_COORD=<Value>
  215.                           ; if METHOD=GIVENPOINT we need (X/Y)
  216.                           ; Default is (0/0)
  217.                         - Y_COORD=<Value>
  218.                           ; if METHOD=GIVENPOINT we need (X/Y)
  219.                           ; Default is (0/0)
  220.                         - KEEPSIZE
  221.                           ; if this keyword is set, it is NOT tried to
  222.                           ; readjust the image size and to center the
  223.                           ; image, so that parts, which would be out of
  224.                           ; range won't be cut off (which works best
  225.                           ; with (X/Y) pairs in the left, upper quarter)
  226.   ----------------------------------------------------------------------------
  227.   ControlPad-Name     : "ENV:superview-library/Scale50.controlpad"
  228.   ControlPad-Commands : - METHOD=<HALF|DOUBLE>
  229.                           ; scale to which size ?
  230.   ----------------------------------------------------------------------------
  231.   ControlPad-Name     : "ENV:superview-library/XOR.controlpad"
  232.   ControlPad-Commands : - XORVALUE = <0..255>
  233.                           ; 0 and 255 will not be the best decision.
  234.                           ; Use 15 or something like this.
  235.   ----------------------------------------------------------------------------
  236.  
  237.